home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / win / wpshell.zip / README.1ST < prev    next >
Text File  |  1995-01-05  |  17KB  |  416 lines
  1. ========================================================================
  2. ==                                                                    ==
  3. ==   W O R K P L A C E   S H E L L   F O R   W I N D O W S   3 . 1    ==
  4. ==                                                                    ==
  5. ==                    V e r s i o n   1 . 0                           ==
  6. ==                                                                    ==
  7. ==                                                                    ==
  8. == Release Date  : 01/05/95                                           ==
  9. ==                                                                    ==
  10. ==                                                                    ==
  11. ==      Copyright IBM Corporation, 1994.  All rights reserved         ==
  12. ==                                                                    ==
  13. ========================================================================
  14.  
  15. TABLE OF CONTENTS (in order of apperance):
  16. ==========================================
  17.  
  18.     1) Minimum Program Requirements
  19.     2) Subscribing To Package
  20.     3) When You Encounter A Problem
  21.     4) Release File List
  22.     5) Installation (and Uninstallation) Instructions.
  23.     6) Editing Your SYSTEM.INI File
  24.     7) Editing Your WIN.INI File
  25.     8) Known Problems
  26.  
  27.  
  28. ------------------------------------------------------------------------
  29. 1)     M I N I M U M   P R O G R A M   R E Q U I R E M E N T S
  30. ------------------------------------------------------------------------
  31.  
  32.    Hardware:
  33.       Processor : Intel 80386SX (or compatible).
  34.       Memory    : about 350K (when loaded and running).
  35.       Disk      : about 650K after installation with all support files.
  36.       Video     : Minimum of VGA (640x480 16 color).
  37.  
  38.    Software:
  39.       DOS 5.x with Windows 3.1 or Windows for Workgroups 3.1 or higher.
  40.       -or-
  41.       OS/2 2.1x or higher (WPSFWIN is installed on Win-OS/2 full-screen session).
  42.  
  43.  
  44. ------------------------------------------------------------------------
  45. 2)        S U B S C R I B I N G   T O   P A C K A G E
  46. ------------------------------------------------------------------------
  47.  
  48. Through OS/2 Developer Connection CD:
  49.  
  50.    WPSFWIN will be updated quaterly through the OS/2 DEVCON CDs.
  51.    Call IBM to subscribe to this great CD product.
  52.  
  53.  
  54. Through IBM VM:
  55.  
  56.    Send requests for WPSHELL package to WPSFWIN at BCRVMPC2:
  57.  
  58.       TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN GET WPSHELL PACKAGE
  59.  
  60.  
  61.    To subscribe to future updates of the package issue the command:
  62.  
  63.       TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN SUBSCRIBE WPSHELL PACKAGE
  64.  
  65.  
  66. ------------------------------------------------------------------------
  67. 3)    W H E N   Y O U   E N C O U N T E R   A   P R O B L E M
  68. ------------------------------------------------------------------------
  69.  
  70. To ask any questions, report any problems, or send any comments,
  71. please append them to:
  72.  
  73.         COMPUSERV :  OS/2 Developers Connection forum.
  74.  
  75.         IBM FORUM :  WPSFWIN FORUM (in IBMPC conference disk).
  76.                      and
  77.                      WPSFWIN 941FORUM (archived appends from 3/94-6/94).
  78.  
  79.         MAIL      :  WPS for Windows
  80.                      IBM
  81.                      Internal Zip 1211
  82.                      1000 NW 51st Street
  83.                      Boca Raton, FL 33431
  84.  
  85.  
  86. NOTE: When sending a problem report please include the following
  87.       information in your note:
  88.          - Windows (3.1 or 3.11) and DOS (5.x or 6.x) versions.
  89.          - Computer manufacturer and model number.
  90.          - Video adapter manufacturer and resolution mode tested in.
  91.          - Amount of RAM memory.
  92.          - Processor type and clock speed.
  93.          - Any software that is automatically loaded by Windows.
  94.            (such as Adobe Type Manager (ATM), screen savers, ect...).
  95.  
  96.  
  97. ------------------------------------------------------------------------
  98. 4)            R E L E A S E   F I L E   L I S T
  99. ------------------------------------------------------------------------
  100.  
  101. Files that make up this release of Workplace Shell for Windows are:
  102.  
  103. Run-time:
  104.     WPSHELL.EXE     : Workplace Shell for Windows executable.
  105.     WNDLIST.EXE     : Workplace Shell for Windows task manager replacement.
  106.     FCLNBW.DLL      : IBM CUA Notebook control library.
  107.     FCLSPBW.DLL     : IBM CUA Spin Button control library.
  108.     CTL3D.DLL       : Microsoft 3-D controls library.
  109.     WARPICON.DLL    : OS/2 WARP 3.0 icon library supplement.
  110.     OS21ICON.DLL    : OS/2 2.1 icon library (old WPSHELL.EXE icon set).
  111.  
  112. Language-dependent:
  113.     WPS_XXXX.DLL    : WPSHELL.EXE NLS resource library.
  114.     PTW_XXXX.DLL    : PMTOWP.EXE NLS resource library.
  115.     CNV_XXXX.DLL    : CONVINI.EXE NLS resource library.
  116.  
  117.     Where "XXXX" is one of the following languages:
  118.        DANI : Danish.
  119.        DUTC : Dutch.
  120.        ENUS : English (US).
  121.        FREN : French (Canadian).
  122.        GRMN : German.
  123.        PORT : Portuguese (Brazilian).
  124.        SPAN : Spanish.
  125.        SWED : Sweeden.
  126.  
  127. Documentation:
  128.     README.1ST      : (This file) "Read Me First" file containing basic
  129.                       directions on what to do with this program.
  130.     WPSHELL.HLP     : Workplace Shell for Windows help file.
  131.  
  132. Support Utilities:
  133.     CONVINI.EXE     : Conversion utility for WPSHELL.INI files 0.5.x -> 1.0.
  134.     PMTOWP.EXE      : Program Manager to Workplace Shell desktop migration
  135.                       utility (always run from PROGMAN).
  136. Optional:
  137.     IBMWALL.BMP     : "IBM" Wallpaper for Windows (copy in \WINDOWS directory).
  138.  
  139.  
  140.  
  141. ------------------------------------------------------------------------
  142. 5)        I N S T A L L A T I O N   I N S T R U C T I O N S
  143. ------------------------------------------------------------------------
  144.  
  145.    First and foremost, If you receive a WPSHELL.ZIP file, uncompress it
  146. using PKUNZIP (version 2.04e or above) into a diskette or directory.
  147.  
  148. (A) Automatic (recommended):
  149. ---------------------------
  150.  
  151.     1) Run Workplace Shell for Windows installation program.
  152.        For example, if run from a diskette select "File" menu in
  153.        Program Manager and choose "Run...".  Then, type "a:\setup.exe"
  154.        and press ENTER.
  155.  
  156.     2) If this is an upgrade from a 0.5.x version, answer "Yes" when
  157.        asked if you want to upgrade.  Then go to step (4).
  158.        If this is a new install, then answer "No".  Then proceede
  159.        to step (3).
  160.  
  161.     3) Choose Express setup (recommended).
  162.  
  163.     4) After the installation has completed, it will restart Windows 3.1x
  164.        and the new shell will take effect.  If you experience any problems
  165.        at this point, please refer to the "When You Encounter A Problem"
  166.        section above.
  167.  
  168.  
  169. (B) Manual:
  170. ----------
  171.  
  172.     1) Uncompress files listed in the "Release File List" above by using
  173.        EXPAND.EXE (in \DOS directory) and copy expanded files into a
  174.        destination directory (i.e. \WPSHELL).
  175.  
  176.        Copy the following files in your \WINDOWS\SYSTEM directory:
  177.  
  178.           FCLNBW.DLL      : IBM CUA Notebook control library.
  179.           FCLSPBW.DLL     : IBM CUA Spin Button control library.
  180.           CTL3D.DLL       : Microsoft 3-D controls library.
  181.  
  182.        Copy file WPSHELL.HLP into the \WINDOWS directory.
  183.  
  184.        Copy NLS resource libraries that match the language you have installed
  185.        in Windows.  Look in WIN.INI file "[Intl]" section, "sLanguage" key
  186.        and find out which language it is. Following are some of the language
  187.        codes used by Windows:
  188.  
  189.        "sLanguage"   Name                          Resource Library
  190.  
  191.           dan        Danish                        DANI
  192.           deu        German                        GRMN
  193.           eng        International English         ENUS
  194.           enu        U.S. English                  ENUS
  195.           esn        Modern Spanish                SPAN
  196.           esp        Castilian Spanish             SPAN
  197.           fin        Finnish
  198.           fra        French                        FREN
  199.           frc        French Canadian               FREN
  200.           isl        Icelandic
  201.           ita        Italian
  202.           nld        Dutch                         DUTC
  203.           nor        Norwegian
  204.           ptb        Brazilian Portuguese          PORT
  205.           ptg        Portuguese                    PORT
  206.           sve        Swedish                       SWED
  207.  
  208.  
  209.     2) Run PMTOWP.EXE from Program Manager's "File" -> "Run..." menu.
  210.  
  211.     4) Manually change the following SYSTEM.INI entries in the [boot] section:
  212.  
  213.          taskman.exe=taskman.exe    (if any, most will not have this line)
  214.          shell=progman.exe
  215.  
  216.             to
  217.  
  218.          taskman.exe=<path>\wndlist.exe     (add if it does not exists)
  219.          shell=<path>\wpshell.exe
  220.  
  221.          (where <path> is the directory where WPSHELL.EXE is stored).
  222.  
  223.     5) Exit Windows and restart so that the new shell will take effect.
  224.        If you experience any problems at this point, please refer to the
  225.        "When You Encounter A Problem" section above.
  226.  
  227.    Optional Step In Manual Installation:
  228.    ------------------------------------
  229.  
  230.     6) Copy IBMWALL.BMP to the \WINDOWS directory and using the
  231.        "Control Panel" -> "Desktop" application change the background bitmap
  232.        to it and check the "Tile" attribute.
  233.  
  234.  
  235.  
  236. (C) Uninstall Instructions:
  237. --------------------------
  238.  
  239.    1) If in Windows, exit Windows.
  240.  
  241.    2) Edit SYSTEM.INI file in \WINDOWS directory and replace the following
  242.       lines:
  243.  
  244.       taskman.exe=<path>\wndlist.exe
  245.       shell=<path>\wpshell.exe
  246.  
  247.       with
  248.  
  249.       taskman.exe=taskman.exe
  250.       shell=progman.exe
  251.  
  252.    3) Restart Windows 3.1.
  253.  
  254.    4) Remove the following files from your \WINDOWS\SYSTEM directory:
  255.  
  256.           FCLNBW.DLL      : IBM CUA Notebook control library.
  257.           FCLSPBW.DLL     : IBM CUA Spin Button control library.
  258.  
  259.  
  260. ------------------------------------------------------------------------
  261. 6)     E D I T I N G   Y O U R   S Y S T E M . I N I   F I L E
  262. ------------------------------------------------------------------------
  263.  
  264.    A "Workplace_Shell_for_Windows" section is created (and maintained)
  265. automatically by WPSFWIN in your SYSTEM.INI file in the \WINDOWS directory.
  266.  
  267.    The SYSTEM.INI file is where Windows 3.1 and other system-related
  268. applications and drivers keep vital information that reflects or changes
  269. the behavior of the system.  This is a pure text file (ASCII-file) that
  270. can be edited by any of your favorite ASCII editors (i.e. e, epm, edit).
  271.  
  272.    WPSFWIN will create (if you edit the "System" settings notebook) a
  273. Workplace Shell for Windows section in this file when you change any of
  274. the "System" default settings.  This section will look something like this
  275. (and it will probably be at the end of the SYSTEM.INI file):
  276.  
  277. [Workplace_Shell_for_Windows]
  278. DESKTOP_HorzIconIndent=23               (other values:0-32,000)
  279. DESKTOP_VertIconIdent=5                 (other values:0-32,000)
  280. SYSTEM_ConfirmOnDelete=Yes              (other values: No)
  281. SYSTEM_ConfirmOnFolderDelete=Yes        (other values: No)
  282. SYSTEM_ButtonApperance=Minimize         (other values: Hide)
  283. SYSTEM_Animation=Enabled                (other values: Disabled)
  284. SYSTEM_MinBehavior=MinToViewer          (other values: Hide and MinToDesktop)
  285. SYSTEM_OpenBehavior=CreateNew           (other values: DisplayExisting)
  286. SYSTEM_SystemSetupFolderName=System Setup (depends on the language installed)
  287. COLOR_ShadowText=00FF00                 (other values: <Blue><Green><Red>)
  288.  
  289.    As you can see must of the entries in the section are self-explanatory.
  290. The "ConfirmOnDelete" entry lets WPSFWIN know that you want to confirm
  291. all delete operations done in the shell.  "ConfirmOnFolderDelete" is
  292. a sub-classed "ConfirmOnDelete", this means that if "ConfirmOnDelete" is
  293. "No", the "ConfirmOnFolderDelete" will take precedence for delete operations
  294. done on folder objects (recommened default settings is "Yes").
  295.  
  296.    Also, The whole "Window" page in the "System" settings notebook is
  297. listed. You can edit these entries manually if you want, but they won't
  298. take effect until you restart Windows or open the "System" settings
  299. notebook again and press "Default" on the "Windows" page.
  300.  
  301.    Notice the "other values" possible in each entry in the WPSFWIN section.
  302. These values can be case-insensitive.
  303.  
  304.    The "COLOR_ShadowText" is a BGR triplet mapped to 2-digit hexadecimal
  305. values.  Each primary color can be a hexadecimal value from 00 to FF.
  306. Therefore, if you want bright cyan, for example, you would want the Blue and
  307. Green primary colors full brightness (hex. FF).  So, the final SYSTEM.INI
  308. entry for COLOR_ShadowText would be FFFF00.
  309.  
  310.    If you are not familiar with the meaning of these values, refer to any
  311. OS/2 2.x user's manual.
  312.  
  313.     Also, I would like to explain the other entries made and used by WPSFWIN
  314. in SYSTEM.INI:
  315.  
  316.    [boot]
  317.    taskman.exe=<path>\wndlist.exe
  318.    shell=<path>\wpshell.exe
  319.  
  320.    These two entries are the core of how WPSFWIN is able to substitute
  321. PROGMAN "seamlessly".  Windows 3.1 uses these two key entries to figure
  322. out who will be handling the task management for the user, and who will
  323. become the default Windows GUI shell to the user.
  324.  
  325.    The entry "taskman.exe=<path>\wndlist.exe" makes the WPSFWIN "Window
  326. List" the default task manager.  If you ever want to switch to the
  327. original "Task Manager" that comes with Windows 3.1, just manually edit
  328. this line and make it: "taskman.exe=taskman.exe". Just that simple!
  329.  
  330.    The entry "wpshell.exe=<path>\wpshell.exe" makes WPSHELL.EXE become
  331. the default GUI for Windows 3.1.  If you ever decide that WPSFWIN is not
  332. the "cola" for you... just edit that statement to "shell=progman.exe".
  333. Easy huh!?, and you don't even need a bottle opener!!
  334.  
  335.  
  336.  
  337. ------------------------------------------------------------------------
  338. 7)      E D I T I N G   Y O U R   W I N . I N I   F I L E
  339. ------------------------------------------------------------------------
  340.  
  341.    The "WPSFWIN System Event Sounds", just like its OS/2 counterpart
  342. (but to a lesser degree), registers 5 system events when installed.
  343. These event registrations are just 5 more lines in your WIN.INI file.
  344. Just look for the "[sounds]" section of the file, and you'll find many
  345. system events and the sounds (WAV files) associated with them listed.
  346. At the bottom of the list, there should be 5 entries of this form
  347. (if no associations have been done):
  348.  
  349. WPBeginDrag=,Workplace Shell Begin Drag
  350. WPEndDrag=,Workplace Shell End Drag
  351. WPFolderClose=,Workplace Shell Folder Close
  352. WPFolderOpen=,Workplace Shell Folder Open
  353. WPShred=,Workplace Shell Shred
  354.  
  355.    Notice that there are no *.WAV files associated with them.  The
  356. easiest way to do it is by selecting the "Control Panel"'s "Sounds" program.
  357. It will read the events for you and let you associate sounds to them.
  358.  
  359.    If you ever want to edit the name of the events, edit the text at the
  360. END of the line.  For example if I wanted to change the description of
  361. the "Workplace Shell Folder Close" event to "Close'em up!", here is what
  362. you'll need to edit:
  363.  
  364. <from>:
  365. WPFolderClose=,Workplace Shell Folder Close
  366.  
  367. <to>:
  368. WPFolderClose=,Close'em up!
  369.  
  370.    If you ever want to delete all events from you Windows 3.1 system,
  371. delete all 5 lines and voila! They're gone.
  372.  
  373.  
  374. ------------------------------------------------------------------------
  375. 8)                  K N O W N   P R O B L E M S
  376. ------------------------------------------------------------------------
  377.  
  378.    8.1) The "Disappearing-Desktop" problem (or ATM-bug) is caused by
  379.         the automatic loading of the Adobe Type Manager (ATM) drivers
  380.         in SYSTEM.INI.  We have been able to isolate the problem to the
  381.         loading of the drivers while WPSFWIN is the default Windows shell.
  382.         To quickly fix this problem, manually edit your SYSTEM.INI file
  383.         and comment out the following lines by placing a ';' (semi-colon)
  384.         at the beginning of the line:
  385.  
  386.         system.drv=atmsys.drv
  387.         atm.system.drv=system.drv
  388.  
  389.         <to>
  390.  
  391.         ;system.drv=atmsys.drv
  392.         ;atm.system.drv=system.drv
  393.  
  394.  
  395.    8.2) When running Program Manager AND Workplace Shell together, Program
  396.         Manager will respond to any "PROGMAN" and "SHELL" DDE services.
  397.         The "PROGMAN" DDE service is used by installation program to create
  398.         and query program groups and items.
  399.         The "SHELL" DDE service is used by Windows DOS applications and
  400.         DOS "boxes" to associate title text and icons to them.
  401.         Therefore, if installing a new software application, be aware that
  402.         you must run Workplace Shell alone for it to communicate correctly
  403.         with the installing application.
  404.  
  405.  
  406.    8.3) OS/2 Warp users installing under Win-OS/2 sessions will not get
  407.         their Windows session restarted after WPSFWIN installation completes.
  408.         You will see an error message like "Error loading USER.EXE" and
  409.         the OS/2 desktop will appear immediatedly after that.
  410.         The WPSFWIN installation program will work under native Windows 3.1x
  411.         without any problems.
  412.  
  413.  
  414. ------------------------------------------------------------------------
  415. END OF 'README.1ST' FILE
  416.